home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / rgbwritemask.z / rgbwritemask
Encoding:
Text File  |  2002-10-03  |  3.3 KB  |  67 lines
  1.  
  2.  
  3.  
  4. RRRRGGGGBBBBwwwwrrrriiiitttteeeemmmmaaaasssskkkk((((3333GGGG))))                                              RRRRGGGGBBBBwwwwrrrriiiitttteeeemmmmaaaasssskkkk((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      RRRRGGGGBBBBwwwwrrrriiiitttteeeemmmmaaaasssskkkk - grants write access to a subset of available bitplanes
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd RRRRGGGGBBBBwwwwrrrriiiitttteeeemmmmaaaasssskkkk((((rrrreeeedddd,,,, ggggrrrreeeeeeeennnn,,,, bbbblllluuuueeee))))
  13.      sssshhhhoooorrrrtttt rrrreeeedddd,,,, ggggrrrreeeeeeeennnn,,,, bbbblllluuuueeee;;;;
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _r_e_d     expects the mask for the corresponding red bitplanes.
  17.  
  18.      _g_r_e_e_n   expects the mask for the corresponding green bitplanes.
  19.  
  20.      _b_l_u_e    expects the mask for the corresponding blue bitplanes.
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      RRRRGGGGBBBBwwwwrrrriiiitttteeeemmmmaaaasssskkkk sets the red, green, and blue write mask components of the
  24.      currently active GL framebuffer, one of normal, popup, overlay, or
  25.      underlay as specified by ddddrrrraaaawwwwmmmmooooddddeeee, to the specified values.  The alpha
  26.      mask component is set to enable writing to all alpha bitplanes.  The
  27.      current framebuffer must be in RGB mode for the RRRRGGGGBBBBwwwwrrrriiiitttteeeemmmmaaaasssskkkk command to
  28.      be applicable.  All drawing into the color bitplanes of the current
  29.      framebuffer is masked by the current write mask.  Write mask components
  30.      are retained in each draw mode, so when a draw mode is re-entered, the
  31.      red, green, blue, and alpha masks are reset to the last values specified
  32.      in that draw mode.
  33.  
  34.      Each write mask component is an 8-bit mask, which allows changes only to
  35.      bitplanes corresponding to ones in the mask.  For example,
  36.      RRRRGGGGBBBBwwwwrrrriiiitttteeeemmmmaaaasssskkkk((((0000xxxxFFFF0000,,,,0000xxxx00000000,,,,0000xxxx00000000)))) allows changes only to the 4 most
  37.      significant bits of red, and to all the bits of alpha.  Bits 8 through 15
  38.      of each component specification are ignored, only bits 0 through 7 are
  39.      significant.
  40.  
  41.      It is an error to call RRRRGGGGBBBBwwwwrrrriiiitttteeeemmmmaaaasssskkkk while the current framebuffer is in
  42.      color map mode.
  43.  
  44.      The write mask components of all framebuffers in RGB mode are set to 0xFF
  45.      when ggggccccoooonnnnffffiiiigggg is called.
  46.  
  47. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  48.      drawmode, gRGBmask, RGBmode, wmpack
  49.  
  50. NNNNOOOOTTTTEEEE
  51.      On Impact and Infinite Reality individual bits within a component cannot
  52.      be masked.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.